Dữ liệu K-line

Mô tả API

Lấy dữ liệu K-line, có thể truy vấn dữ liệu K-line của token chỉ định (chỉ hỗ trợ cặp USDT) trong khoảng thời gian chỉ định, tối đa 1000 nến.

Tình huống sử dụng:

• Truy vấn dữ liệu K-line với các loại cửa sổ thời gian khác nhau
• Kết hợp K-line giá để đánh giá thời điểm mua/bán

Tần suất cập nhật dữ liệu: Cập nhật thời gian thực theo bucketType

URL yêu cầu

• Phương thức: POST
• Đường dẫn: /open/v1/trade/kline/getTradeKLineList

Điểm tín phí

• Điểm tín phí mỗi lần gọi: 2

Điều kiện tiên quyết

Lấy vsTokenId

Điều kiện	Mô tả	Cách lấy
Đã có vsTokenId	Dùng vsTokenId đã cache, không cần truy vấn lại	Tự động trích xuất từ ngữ cảnh
Chưa có vsTokenId	Gọi API POST /vs-token/list	Gọi API tiên quyết

Tham số yêu cầu

Tham số gửi trong body dạng JSON.

Tên tham số	Kiểu	Bắt buộc	Mô tả
vsTokenId	long	Có	ID token
bucketType	string	Có	Loại cửa sổ thời gian K-line
startTime	long	Không	Thời gian bắt đầu (timestamp ms)
endTime	long	Có	Thời gian kết thúc (timestamp ms)
size	integer	Không	Số bản ghi truy vấn, mặc định 360, tối đa 1000

Giải thích giá trị enum

bucketType - Loại cửa sổ thời gian K-line

Giá trị	Ý nghĩa
5m	5 phút
15m	15 phút
30m	30 phút
1h	1 giờ
4h	4 giờ
1d	1 ngày
1w	1 tuần

Trường phản hồi

Chỉ liệt kê cấu trúc trường trong object data:

Trường	Kiểu	Kiểu thực tế trả về	Mô tả
vsTokenId	long	string	ID token
symbol	string	string	Ký hiệu token
name	string	string	Tên token
klineType	string	string	Loại K-line
klineData	array	array	Dữ liệu K-line
time	long	long	Thời gian (timestamp ms)
open	number	string	Giá mở cửa
close	number	string	Giá đóng cửa
high	number	string	Giá cao nhất
low	number	string	Giá thấp nhất
volume	number	string	Khối lượng
amount	number	string	Doanh thu (USD)

Ý nghĩa nghiệp vụ

Trường	Ý nghĩa nghiệp vụ	Gợi ý sử dụng
volume	Khối lượng giao dịch	Phản ánh mức độ hoạt động giao dịch trong chu kỳ thời gian
amount	Doanh thu	Số tiền giao dịch tính bằng USD; kết hợp volume để tính giá trung bình

Ví dụ yêu cầu

{
    "vsTokenId": 1,               // ID token
    "bucketType": "5m",            // Loại cửa sổ thời gian K-line
    "endTime": 1773478632535,      // Thời gian kết thúc
    "size": 20                     // Số bản ghi; mặc định 360, tối đa 1000
}

Ví dụ cURL (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/trade/kline/getTradeKLineList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "bucketType": "5m",
    "endTime": 1773478632535,
    "size": 20
}'

Ví dụ cURL (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/trade/kline/getTradeKLineList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"bucketType\": \"5m\",    \"endTime\": 1773478632535,    \"size\": 20}"

Ví dụ phản hồi thành công

{
    "code": 200,
    "message": "success",
    "data": {
        "vsTokenId": "1",                       // ID token
        "symbol": "BTC",                         // Ký hiệu token
        "name": "Bitcoin",                       // Tên token
        "klineType": "01",                       // Loại K-line
        "klineData": [
            {
                "time": 1773478200000,            // Thời gian
                "open": "70544.92",                // Giá mở cửa
                "close": "70594.48",               // Giá đóng cửa
                "high": "70594.49",                // Giá cao nhất
                "low": "70536.58",                 // Giá thấp nhất
                "volume": "20.543779999999995",    // Khối lượng
                "amount": "1449509.9399093997"     // Doanh thu (USD)
            },
            {
                "time": 1773477900000,
                "open": "70562.01",
                "close": "70544.92",
                "high": "70586.21",
                "low": "70536.72",
                "volume": "57.95012",
                "amount": "4089095.6473876997"
            },
            {
                "time": 1773477600000,
                "open": "70612.38",
                "close": "70562",
                "high": "70613.76",
                "low": "70562",
                "volume": "14.238029999999998",
                "amount": "1004960.1104217"
            }
            // ... thêm dữ liệu bị lược bỏ
        ]
    },
    "requestId": "xxx-xxx-xxx"
}